feat: document automatic account linking for Google and Apple providers#2474
Merged
feat: document automatic account linking for Google and Apple providers#2474
Conversation
Add documentation for the new account_linking_mode provider setting that enables automatic account linking for Google and Apple consumer accounts. Changes: - Update account linking page with new section covering automatic linking for Google and Apple, including how it works, restrictions, configuration instructions (Console and CLI), and security requirements. - Update security considerations to reflect that Google and Apple now support automatic linking, replacing the previous forward-looking language. - Add account linking sections to the Google and Apple provider pages with cross-references to the main documentation. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
jonas-jonas
approved these changes
Mar 16, 2026
vinckr
reviewed
Mar 16, 2026
Co-authored-by: Vincent <vincent@ory.sh>
…ic-account-linking
… into hperl/automatic-account-linking
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
5 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Documents the new
account_linking_modeprovider setting that enables automatic account linking for Google and Apple consumer accounts.Changes
95_account-linking.mdx): Added new section covering automatic linking for Google and Apple, including how it works, restrictions, configuration instructions (Console and CLI), and security requirements. Updated security considerations to reflect that these providers now support automatic linking.10_google.mdx): Added account linking section with cross-reference.30_apple.mdx): Added account linking section with cross-reference.Context
Ory now supports automatic account linking for Google (consumer accounts only) and Apple. When enabled via
account_linking_mode: automatic, users signing in with these providers are automatically linked to existing accounts that share a verified email address, without requiring password verification.Google Workspace accounts are excluded because expired domains can be re-registered by an attacker.